home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
c
/
mc302emb.zip
/
EMCF.DOC
< prev
next >
Wrap
Text File
|
1994-03-18
|
27KB
|
632 lines
================================================================
EEEEEEE MM MM IIIIIII L Y Y CCCC FFFFFF
E M M M M I L Y Y C C F
E M M M I L Y Y C F
EEEE M M I L Y --- C FFFF
E M M I L Y C F
E M M I L Y C C F
EEEEEEE M M IIIIIII LLLLLLL Y CCCC F
================================================================
A
PC Based Simulator
for the
C-FLEA Virtual Processor
Release 1.0
Revised 09-Feb-94
Copyright 1991-1994 Dave Dunfield
All rights reserved
EMILY-CF: A PC based C-FLEA simulator Page: 1
1. INTRODUCTION
EMILY-CF is a software simulator for the C-FLEA Virtual Processor.
It provides a powerful debugging environment, offering many features:
- Supports full 64K of MEMORY. Any portion of memory can be used for
CODE or DATA.
- Hardware emulation mode communciates with a target system, and
allows you to include the physical I/O lines, timers etc. in your
simulation.
- Single step, Multi Step, Animate and Full Speed execution modes.
- Simultanious on-screen displays of program disassembly, memory CPU
registers and simulation messages.
- Full screen editors for CPU registers, I/O registers, a two memory
editors (CODE and DATA). All of the above may be viewed/altered at
any time during the debugging session.
- Multiple breakpoints are transparent to the user program.
1.1 System Requirements
EMILY-CF will run on any IBM PC/AT/PS2 compatible system with a
MDA/CGA/EGA or VGA display, and at least 128K of free system RAM.
- If physical serial I/O is used, a COMM port is required. If
hardware emulation is also used, TWO COMM ports are required.
- Some CGA displays may exibit "snow" or flicker during high speed
screen updates. This effect will not occur with MDA, EGA or VGA
displays.
EMILY-CF: A PC based C-FLEA simulator Page: 2
2. STARTING UP EMILY-CF
If you are using the optional hardware emulation mode, insure that
the resident control software (supplied) is inserted into the target
system, and that the PC running EMILY-CF is connected to the target
systems serial port via COM2. Power on the test system before
starting EMILY. The resident control software must be active when
EMILY "looks" for it.
EMILY-CF is invoked by typing EMCF at the DOS command line. You
will be greeted with a "welcome" screen which displays a reminder of
the command line syntax and the copyright message. This screen will
remain on the display for about 5 seconds (10 seconds in the DEMO
versin). Pressing any key while this screen is visible will bypass
this delay, and proceed directly to the main control panel.
If EMILY-CF is given a file name on the command line, she loads it
in the same manner as if the 'L'oad command had been used from within
the main control panel.
EMILY-CF: A PC based C-FLEA simulator Page: 3
EMILY-CF also accepts several option switches on the command line:
/Hardware[:n] - Enables the hardware emulation feature to cause
EMILY to interact with the target system when
performing I/O accesses. This option may be
followed by a ':' and a numeric value which
defines the BAUD RATE to be used to communicate
with the target system. Default is 9600.
/Mono * - Inhibits the color display, even if a color
adapter is present. This option may be useful
if your monitor/adapter combination provides an
unpleasent or unusable display for EMILY.
/Ports:n - Specify number of parallel I/O ports to provide
on the simulated processor. If not specified,
a default of 4 ports are provided.
/Swapcom - Exchanges the operation of the two serial ports
on the PC. When this option is used, COM2 will
be used for serial I/O redirection.
* Note: If some of the EMILY windows appear to be an un-readable
washed-out yellow color, try adjusting the color contrast on
your monitor. Those windows should be an easy to read brown.
EMILY-CF: A PC based C-FLEA simulator Page: 4
3. USING EMILY-CF
3.1 The Main Control Panel
Once EMILY-CF is up and running, you will be presented with the
"Main Control Panel", which consists of four "windows" displaying:
- A disassembly of program memory (Upper LEFT)
- The contents of CPU registers (Upper CENTER)
- The contents of MEMORY (Upper RIGHT)
- Informational messages from EMILY (Lower portion)
All of EMILY'S functions are accessed by command characters
entered from this screen:
3.1.1 A - Animate execution
This function begins execution of the user program (from the
address in the PC register). As each instruction is executed,
EMILY will display the instruction being executed, the CPU
registers, and the contents of internal RAM in the appropriate
windows.
When you enter the 'A' command, EMILY will prompt you for
the number of instructions to animate. Pressing return (without
entering a number) will cause the animation to proceed
non-stop. Pressing <escape> will return you to the Main Control
Panel.
The animation will terminate when:
- The requested number of instructions have been stepped.
- A breakpoint is encountered.
- An illegal opcode is encountered.
- The <escape> key is pressed on the PC console.
3.1.2 B - set Breakpoint
This command sets a breakpoint such that program execution
under the 'A'nimate, or 'G'o, commands will stop when the
breakpoint address is encountered.
Up to 10 breakpoints may be in effect at the same time.
You will be prompted for the address (in HEX). Pressing
return (without entering an address) will cause the breakpoint
to be set at the current program counter (PC) location.
Pressing <escape> will return you to the main control panel.
EMILY stores the breakpoint addresses internally in a simp